Transit states

The following diagram displays the various transit states that a unit may have:

A transit state identifies a unit as:

N4 records the Time In for a unit when it enters the Yard transit state.

N4 records the Time Out for a unit when it enters the Departed transit state.

For example, if you attach or bundle a unit to another primary unit, N4 retires the attached unit.

The Inbound, EC/In, Yard, EC/Out, and Loaded transit states are sub-states of the Active visit state. Therefore, while in these states, a unit is visible in XPS.

TImestamps

There are several timestamps associated with unit facility visit transit states. Each timestamp is saved for information purposes only.

Field

Description

ufvCreateTime

Creation time of the UFV entity

ufvTimeOfLastMove

Time of the unit move to its current position.

For a new UFV, this is the same as the ufvCreateTime.

ufvTimeOfLoading

Time of placement of the unit onto its outbound carrier.

ufvTimeEcIn

Time when transit state became EC/IN.

  • If arriving by road, the time the truck entered the gate.

  • If arriving by sea, the time of discharge.

ufvTimeEcOut

Time when transit state became EC/OUT.

ufvTimeIn

Time when transit state became YARD.

ufvTimeOut

Time when transit state became DEPARTED.

ufvDivTimeAppntmnt

Time of delivery appointment.

ufvTimeInventory

Time when yard position last verified.

ufvTimeComplete

Time when transit state became DEPARTED or RETIRED. The end of the unit facility visit lifecycle.

Service Events

There are four primary service events recorded for transit state transitions, some of which allow you to begin using additional unit events:

  1. In events: When the unit's inbound carrier transitions to the ARRIVED visit state (on page 1) and the transit state changes to INBOUND. The three specific in events are:

  1. UNIT_IN_VESSEL

  2. UNIT_IN_GATE (external ID: IN_GATE_CONTAINER)

  3. UNIT_IN_RAIL

  1. Off events: Placement of the unit into the yard.

  1. UNIT_DISCHARGE

  1. UNIT_DELIVER

  2. UNIT_DERAMP

  1. On Events: Placement of the unit onto its outbound carrier.

  1. UNIT_LOAD

  1. UNIT_DELIVER

  2. UNIT_RAMP

  1. Out events: When both the transit state and the unit's outbound carrier transition to DEPARTED.

  1. UNIT_OUT_VESSEL

  1. UNIT_OUT_GATE (external ID: OUT_GATE_CONTAINER)

  2. UNIT_OUT_RAIL